home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / start_xact.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.5 KB  |  48 lines
  1. .Na "start_xact" 
  2. .Aa
  3. .Fu
  4. Start a distributed transaction using the commit service.
  5. .Ih "distributed transaction, start"
  6. .Sy
  7. .Sf "DBINT start_xact(connect, application_name, xact_name, site_count)
  8. .Sp "DBPROCESS" "*connect"
  9. .Sp "char" "*application_name"
  10. .Sp "char" "*xact_name"
  11. .Sp "int" "site_count"
  12. .Co
  13. .Bl
  14. This routine records the start of a distributed transaction with the
  15. commit service.
  16. A record is placed in the commit service containing
  17. the \f2commid\fP, which is a number that caller subsequently uses to
  18. identify the transaction to the commit service.
  19. .Bz
  20. .Pa
  21. .Pi connect
  22. A pointer to the DBPROCESS used to communicate with the commit service.
  23. .Pi application_name
  24. The name of the application. This name can be anything the application
  25. chooses. It will appear in the table maintained by the commit service
  26. but is not used by the commit service or the \*S recovery system.
  27. .Pi xact_name
  28. The name of the transaction. 
  29. This name will appear in the table maintained by the commit service and
  30. must be supplied as part of the transaction name string built by 
  31. \f2build_xact_string()\fP.
  32. The name cannot contain a period (``.'') or a colon (``:'').
  33. .Pi site_count
  34. The number of sites participating in the transaction.
  35. .in -.375i
  36. .Re
  37. .br
  38. An integer called the \f2commid\fP. This number is used to identify the
  39. transaction in subsequent calls to the commit service.
  40. In case of error, this routine will return 0.
  41. .Sa
  42. abort_xact,
  43. build_xact_string,
  44. commit_xact,
  45. remove_xact,
  46. scan_xact,
  47. stat_xact
  48.